home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-02 / objtoo11.zip / OBJTOOL.DOC < prev    next >
Text File  |  1992-03-16  |  5KB  |  96 lines
  1.             ObjTool  Copyright (c) 1990-1992  Thomas G. Hanlin III
  2.  
  3.  
  4.  
  5. This is a utility designed to allow you to view or alter object (.OBJ) files.
  6. It verifies that an object file is intact and uncorrupted.  You may display
  7. the public symbols (such as routines in the file that you may call from
  8. another program) and external symbols (such as routines that the file needs
  9. to call on itself).  The names of public and external symbols may be changed
  10. to suit you, which is useful in cases where you have naming conflicts, for
  11. instance.
  12.  
  13. ObjTool is protected by copyright.  However, it may be distributed as long as
  14. all files are included in unmodified condition (this includes OBJTOOL.DOC and
  15. OBJTOOL.EXE).  In addition, no files may be added to the OBJTOOL archive.
  16. This applies specifically to files which contain advertising for BBSes or
  17. other products or services.  I will not allow my programs to be a vehicle for
  18. electronic junk mail.
  19.  
  20. If you find ObjTool useful, it would be nice if you register your copy for
  21. $10.00.  This must be payable through a U.S. bank.  Registration entitles you
  22. to receive a disk containing the latest version of ObjTool, complete with
  23. source code, and a sampler of my other software.  Please specify disk size.
  24.  
  25. ObjTool was written with the TopSpeed Modula-2 compiler.
  26.  
  27. Registrations may be sent to:
  28.  
  29.    Thomas G. Hanlin III
  30.    3544 E. Southern Ave. #104
  31.    Mesa, AZ 85204
  32.  
  33.  
  34.  
  35. The ObjTool command syntax is as follows:
  36.  
  37.    OBJTOOL [options] filename[.OBJ]
  38.  
  39.  
  40.  
  41. Options must be separated by spaces.  They may be abbreviated.  The following
  42. options are available:
  43.  
  44.    /BASIC      Screen out BASIC's runtime symbols.  This prevents the listing
  45.                of external symbols that refer to the runtime library used by
  46.                QuickBASIC and BASCOM programs.
  47.  
  48.    /EXTERNAL   Display external symbol names.  These are the names of
  49.                variables and routines that are external to the object file.
  50.                Such names are combined with the final program by LINK, which
  51.                locates them in other object files or libraries.
  52.  
  53.    /FULL       Display the module name, external symbols and public symbols.
  54.  
  55.    /HELP       Shows a brief help message which lists the available options.
  56.  
  57.    /MODULE     Display the module name.  This is the internal name of the
  58.                object file, which is usually derived from the name of the
  59.                original source file.  This means that you can use this to
  60.                discover which language the object file was written in, by
  61.                looking at the extension of the original source file name.
  62.  
  63.    /PUBLIC     Display public symbol names.  These are the names of variables
  64.                and routines that the object file is willing to share with the
  65.                outside world.  Such names are combined with the final program
  66.                by LINK, which uses them to resolve external symbols required
  67.                by other object files or libraries.
  68.  
  69.    /RENEXT     Rename an external symbol.  This allows you to change the name
  70.                of an external symbol reference.  This is most useful when you
  71.                are using object files for which you do not have the source
  72.                code and have encountered a conflict such that two different
  73.                symbols have been given the same name.  You will be prompted
  74.                for the old name and new name.
  75.  
  76.    /RENPUB     Rename a public symbol.  This allows you to change the name of
  77.                a public symbol.  This is most useful when you are using
  78.                object files for which you do not have the source code and
  79.                have encountered a conflict such that two different symbols
  80.                have been given the same name.  You will be prompted for the
  81.                old name and new name.
  82.  
  83. When renaming an external or public symbol, it is wise to keep in mind
  84. whether the original name was all uppercase, all lowercase, or mixed
  85. uppercase and lowercase.  Some languages expect symbols to be in a particular
  86. lowercase or uppercase format.  For instance, compiled BASIC programs require
  87. most symbols to be uppercase-only.  If you use the wrong convention, the
  88. symbol may become inaccessible.
  89.  
  90. Note that libraries (.LIB files) are nothing more than collections of object
  91. files.  By using the LIB utility, you can extract an object file from the
  92. library, view it or alter it with ObjTool, then put it back into the library.
  93. See your reference manual for further information, or type LIB /HELP for a
  94. brief option listing.  The LIB utility is included with most Microsoft
  95. languages.
  96.